home *** CD-ROM | disk | FTP | other *** search
/ PCGUIA 2010 Software/Programs / PCGuia_programas.iso / Software / Internet / The Dude / dude-install-3.5.exe / data / files / mibs / CISCO-WIRELESS-P2MP-RF-METRICS-MIB.txt < prev    next >
Encoding:
Text File  |  2009-12-11  |  53.6 KB  |  1,530 lines
  1. -- *********************************************************************
  2. -- CISCO-WIRELESS-P2MP-RF-METRICS-MIB.my:  Cisco Wireless Radio Point to
  3. --                                         MultiPoint RF Metrics MIB.
  4. --
  5. -- November 1999, Allan Figueredo
  6. --
  7. -- Copyright (c) 1998-2000 by Cisco Systems, Inc.
  8. -- All rights reserved.
  9. -- 
  10. -- *********************************************************************
  11. --
  12. -- *********************************************************************
  13. --
  14. --
  15. -- 1.0 Glossary
  16. --
  17. -- The following terms are used in the MIB definitions below.
  18. --
  19. -- Radio Interface:   The interface that provides wireless communication
  20. --                    features.
  21. -- Radio Link:   The bi-directional wireless link that exists between 
  22. --               two communicating radios.
  23. -- Radio PHY:    Represents the transmission characteristics of the 
  24. --               Radio Link.
  25. -- RF Unit:      The Radio Frequency components and the associated 
  26. --               antennas.
  27. --
  28. --
  29. --
  30. -- 2.0 Cisco Wireless RF Metrics MIB Organization
  31. --
  32. -- 
  33. --     This MIB contains information about the radio signal(s) that were
  34. --     received or attributes of the radio signals computed from 
  35. --     received signals. This group models the real-time data that is 
  36. --     collected.
  37. --
  38. --     The key characteristics are:
  39. --     1. The amount of information captured in these parameters is 
  40. --        large and cannot be modeled as single values.
  41. --
  42. --     2. They represent real-time information, which cannot be polled
  43. --
  44. --     3. Hardware captures this information.
  45. --        Radio signal characteristics are modeled in three ways:
  46. --        1. Histogram
  47. --        2. Timelines
  48. --        3. Snapshots
  49. --
  50. --
  51. -- o.  History Group
  52. --        This group contains information about the radio system
  53. --        characteristics which are inherently modeled as histograms.
  54. --        Certain characteristics of the radio system may be captured
  55. --        as histograms by the hardware.
  56. --
  57. --        The user may configure these histograms as needed.
  58. --
  59. --        It exists for the following reasons:
  60. --
  61. --        1. The amount of information contained in these parameters is
  62. --           large and cannot be modeled as single values.
  63. --
  64. --        2. They represent real-time information, which cannot be
  65. --           polled for as well.
  66. --
  67. --        3. Key signal processing information cannot be captured by 
  68. --           normal SNMP (say 1 sec poll interval) monitoring.
  69. --
  70. --        4. Hardware captures this information as histograms.
  71. --
  72. --        5. In wireless environments this is key information that needs
  73. --           to be captured for management.
  74. --
  75. -- o.  Timeline Group
  76. --        This group contains information about how raw radio signal
  77. --        characteristics that may be captured.  Timelines are normally
  78. --        associated with a threshold defined in the threshold group.
  79. --
  80. -- o.  Threshold Group  
  81. --        This provides provides facilities to define thresholds
  82. --        on the raw signal attributes that are processed by the
  83. --        hardware. Normally thresholds are used in conjunction
  84. --        with Timelines to capture specific radio signal behavior.
  85. --
  86. -- o.  Snapshot Group   
  87. --        This group provides facilities that may be used to capture
  88. --        multiple radio signal attributes keyed to a single user
  89. --        initiated trigger. Simultaneous capture of multiple real-time
  90. --        attributes keyed to a single trigger provides indepth
  91. --        information about the behavior of the system.
  92. --
  93. --
  94. -- 
  95. -- 3.0   MIB Definitions
  96. --
  97. --
  98.  
  99.  
  100. CISCO-WIRELESS-P2MP-RF-METRICS-MIB DEFINITIONS ::= BEGIN
  101.  
  102.     IMPORTS
  103.     MODULE-IDENTITY, OBJECT-TYPE,
  104.     Integer32, NOTIFICATION-TYPE
  105.         FROM SNMPv2-SMI
  106.     RowStatus, TruthValue,
  107.     TimeInterval, MacAddress 
  108.         FROM SNMPv2-TC
  109.     MODULE-COMPLIANCE, OBJECT-GROUP
  110.         FROM SNMPv2-CONF
  111.         ifIndex, OwnerString
  112.         FROM IF-MIB
  113.     CwrCollectionAction, 
  114.     CwrCollectionStatus, CwrThreshLimitType,
  115.     P2mpRadioSignalAttribute,
  116.         CwrFixedPointScale, CwrFixedPointPrecision,
  117.         CwrFixedPointValue, P2mpSnapshotAttribute,
  118.         CwrUpdateTime 
  119.         FROM CISCO-WIRELESS-TC-MIB
  120.     ciscoMgmt
  121.         FROM CISCO-SMI;
  122.  
  123.     ciscoWirelessRfMetricsMIB MODULE-IDENTITY
  124.            LAST-UPDATED "200004191910Z"
  125.            ORGANIZATION "Cisco Systems Inc."
  126.            CONTACT-INFO
  127.        "    Cisco Systems
  128.         Customer Service
  129.  
  130.        Postal: 170 W Tasman Drive
  131.            San Jose, CA  95134
  132.            USA
  133.  
  134.            Tel: +1 800 553-NETS
  135.                E-mail: wireless-nms@cisco.com"
  136.             DESCRIPTION
  137.             "This is the MIB Module for the Cisco Wireless Radio 
  138.                  Point to MultiPoint interface specification."
  139.        ::= { ciscoMgmt 180}
  140.  
  141. --
  142. -- The Cisco Wireless P2MP Radio RF Metrics MIB Tree
  143. -- 
  144.  
  145. p2mpRadioHistoryGroup   OBJECT IDENTIFIER ::= 
  146.                                          { ciscoWirelessRfMetricsMIB 1 }
  147. p2mpRadioTimelineGroup  OBJECT IDENTIFIER ::= 
  148.                                          { ciscoWirelessRfMetricsMIB 2 }
  149. p2mpRadioThresholdGroup OBJECT IDENTIFIER ::= 
  150.                                          { ciscoWirelessRfMetricsMIB 3 }
  151. p2mpRadioSnapshotGroup  OBJECT IDENTIFIER ::= 
  152.                                          { ciscoWirelessRfMetricsMIB 4 }
  153.  
  154.  
  155.  
  156. --
  157. -- p2mpRadioHistoryGroup.
  158. --
  159. -- The Histogram Table. This table contains information about the set of
  160. -- histograms that the hardware can be programmed to maintain.
  161. --
  162. -- These histograms are generated as follows :
  163. -- Radio signal data is sampled.
  164. -- Occurrences of values of the radio signal data is counted.
  165. -- This count is maintained as discrete sets. Each set represented by
  166. -- one bin.
  167. --
  168. -- Note that the raw radio signal data is not stored in the bins. It is 
  169. -- the count of the occurrence of the radio signal sample that gets 
  170. -- stored.
  171. --
  172.  
  173. p2mpHistCtrlTable OBJECT-TYPE
  174.         SYNTAX SEQUENCE OF P2mpHistCtrlEntry
  175.         MAX-ACCESS not-accessible
  176.         STATUS current
  177.         DESCRIPTION
  178.         "This table contains information about histograms configured in
  179.     hardware."
  180.         ::= { p2mpRadioHistoryGroup 1 }
  181.  
  182. p2mpHistCtrlEntry OBJECT-TYPE
  183.         SYNTAX P2mpHistCtrlEntry
  184.         MAX-ACCESS not-accessible
  185.         STATUS current
  186.         DESCRIPTION
  187.         "This represents one entry in the p2mpHistCtrlTable.  This table
  188.         is indexed by ifIndex, p2mpHistSuMacAddress, and p2mpHistClass.
  189.  
  190.         At the head end:
  191.         Histograms can be created on each upstream channel either on a 
  192.         per channel or per subscriber unit basis.
  193.         
  194.         When histograms are created on a per subscriber unit basis, the 
  195.         user must specify the subscriber unit's MAC address and the 
  196.         ifIndex of the MAC layer (propDocsWirelessMaclayer) at the 
  197.         head end.
  198.  
  199.         When histograms are created on a per channel basis, the user
  200.         must set the MAC address to zero(00 00 00 00 00 00).  The 
  201.         channel ID is specified by the ifIndex of the upstream channel.
  202.         Hence, when creating histograms on a per channel basis, the 
  203.         ifIndex must be set to the ifIndex of the upstream channel 
  204.         (propDocsWirelessUpstream) on which the histogram is to be 
  205.         created.
  206.  
  207.         At the subscriber end:
  208.         Histograms can only be created on the downstream channel.  Since
  209.         there is only one downstream channel, histograms cannot be 
  210.         created per channel ID.  Hence, when a histogram is created, the
  211.         user must set the MAC address (p2mpHistSuMacAdress) to 
  212.         zero(00 00 00 00 00 00).  The ifIndex must be set to the ifIndex
  213.         of the downstream channel (propDocsWirelessDownstream)."
  214.  
  215.         INDEX { ifIndex, p2mpHistSuMacAddress, p2mpHistClass }
  216.         ::= { p2mpHistCtrlTable 1 }
  217.  
  218. P2mpHistCtrlEntry ::= SEQUENCE {
  219.         p2mpHistSuMacAddress    MacAddress,
  220.         p2mpHistClass           P2mpRadioSignalAttribute,
  221.         p2mpHistSize            INTEGER,
  222.         p2mpHistSumScale        CwrFixedPointScale,
  223.         p2mpHistSumPrecision    CwrFixedPointPrecision,
  224.         p2mpStartBinValue       Integer32,
  225.         p2mpEndBinValue         Integer32,
  226.         p2mpCollDuration        CwrUpdateTime,
  227.         p2mpUpdateRate          CwrUpdateTime,
  228.         p2mpPeriodicSum         TruthValue,
  229.         p2mpHistOwner           OwnerString,
  230.         p2mpHistAction          CwrCollectionAction,
  231.         p2mpHistStatus          CwrCollectionStatus,
  232.         p2mpHistRowStatus       RowStatus
  233.         }
  234.  
  235. p2mpHistSuMacAddress OBJECT-TYPE
  236.         SYNTAX MacAddress
  237.         MAX-ACCESS not-accessible
  238.         STATUS current
  239.         DESCRIPTION
  240.         "This object is used to index this table.
  241.         At the head end:
  242.            When a histogram is created on a per subscriber unit basis,
  243.            this object should reflect the MAC address of the subscriber
  244.            unit.
  245.            When a histogram is created on a per channel basis, this 
  246.            object must be set to zero(00 00 00 00 00 00).
  247.         At the subscriber end:
  248.            When creating a histogram, this object must always be set to
  249.            zero (00 00 00 00 00 00)."
  250.         ::= { p2mpHistCtrlEntry 1 }
  251.  
  252. p2mpHistClass OBJECT-TYPE
  253.         SYNTAX P2mpRadioSignalAttribute
  254.         MAX-ACCESS not-accessible
  255.         STATUS current
  256.         DESCRIPTION
  257.         "This objects used to index this table.  It represents the
  258.          attribute that is being histogrammed."
  259.         ::= { p2mpHistCtrlEntry 2 }
  260.  
  261. p2mpHistSize OBJECT-TYPE
  262.         SYNTAX INTEGER {
  263.                   fine(1),
  264.                   coarse(2)
  265.                }
  266.         MAX-ACCESS read-create
  267.         STATUS current
  268.         DESCRIPTION
  269.         "This object lets the user select the granularity of the 
  270.         histogram. The number of bins used for the capture in 
  271.         each category is hardware dependent."
  272.         ::= { p2mpHistCtrlEntry 3 }
  273.  
  274. p2mpHistSumScale OBJECT-TYPE
  275.         SYNTAX        CwrFixedPointScale
  276.         MAX-ACCESS    read-only
  277.         STATUS        current
  278.         DESCRIPTION
  279.         "This variable indicates the exponent to apply to the 
  280.         fixed-point values in the histogram summary table."
  281.         ::= { p2mpHistCtrlEntry 4 }
  282.  
  283. p2mpHistSumPrecision OBJECT-TYPE
  284.         SYNTAX        CwrFixedPointPrecision
  285.         MAX-ACCESS    read-only
  286.         STATUS        current
  287.         DESCRIPTION
  288.         "This variable indicates the number of decimal places used for 
  289.         precision when interpreting the fixed-point values in the 
  290.         histogram summary table."
  291.         ::= { p2mpHistCtrlEntry 5 }
  292.  
  293. p2mpStartBinValue OBJECT-TYPE
  294.         SYNTAX Integer32 (-2147483647..2147483647)
  295.         MAX-ACCESS read-create
  296.         STATUS current
  297.         DESCRIPTION
  298.         "This object represents the maximum of the values that will be
  299.         collected in the first bin of the histogram.
  300.         All values <= p2mpStartBinValue are kept in the first histogram
  301.         bin."
  302.         ::= { p2mpHistCtrlEntry 6 }
  303.  
  304. p2mpEndBinValue OBJECT-TYPE
  305.         SYNTAX Integer32 (-2147483647..2147483647)
  306.         MAX-ACCESS read-create
  307.         STATUS current
  308.         DESCRIPTION
  309.         "This object represents the minimum of the values that will be
  310.         collected in the last bin of the histogram.
  311.         All values >= p2mpEndBinValue are kept in the last histogram 
  312.         bin."
  313.         ::= { p2mpHistCtrlEntry 7 }
  314.  
  315. p2mpCollDuration OBJECT-TYPE
  316.         SYNTAX CwrUpdateTime
  317.         UNITS "seconds"
  318.         MAX-ACCESS read-create
  319.         STATUS current
  320.         DESCRIPTION
  321.         "This object specifies the duration for which this histogram 
  322.         must be accumulated. After successfully accumulating data for 
  323.         this amount of time the collection stops and the p2mpHistStatus
  324.         changes to statusCaptured."
  325.         ::= { p2mpHistCtrlEntry 8 }
  326.  
  327. p2mpUpdateRate OBJECT-TYPE
  328.         SYNTAX CwrUpdateTime
  329.         UNITS "seconds"
  330.         MAX-ACCESS read-create
  331.         STATUS current
  332.         DESCRIPTION
  333.         "This object represents rate at which snapshots of the histogram
  334.         will be available." 
  335.         ::= { p2mpHistCtrlEntry 9 }
  336.  
  337. p2mpPeriodicSum OBJECT-TYPE
  338.         SYNTAX TruthValue
  339.         MAX-ACCESS read-create
  340.         STATUS current
  341.         DESCRIPTION
  342.         "The histogram data is updated every p2mpUpdateRate seconds.
  343.         When set to true(1), the latest histogram data set is summed
  344.         with the previous histogram data set and the
  345.         p2mpHistSummaryTable will reflect cumulative values.
  346.  
  347.         When set to false(2), only the latest data set is made available
  348.         and the p2mpHistSummarytable will reflect the latest values."
  349.         ::= { p2mpHistCtrlEntry 10 }
  350.  
  351. p2mpHistOwner OBJECT-TYPE
  352.         SYNTAX OwnerString
  353.         MAX-ACCESS read-create
  354.         STATUS current
  355.         DESCRIPTION
  356.     "This object identifies management station that created this
  357.     histogram specification."
  358.         ::= { p2mpHistCtrlEntry 11 }
  359.  
  360. p2mpHistAction OBJECT-TYPE
  361.         SYNTAX CwrCollectionAction
  362.         MAX-ACCESS read-create
  363.         STATUS current
  364.         DESCRIPTION
  365.         "This object represents the action to be carried out on this 
  366.         histogram specification. If a histogram has been successfully
  367.         captured then it must be cleared before an other capture
  368.         may be initiated."
  369.         ::= { p2mpHistCtrlEntry 12 }
  370.  
  371. p2mpHistStatus OBJECT-TYPE
  372.         SYNTAX CwrCollectionStatus
  373.         MAX-ACCESS read-only
  374.         STATUS current
  375.         DESCRIPTION
  376.         "This object represents the current state of this histogram. 
  377.         Once the histogram collection is complete the status changes to
  378.         statusCaptured and the data is available for use.
  379.         None of the parameters of a histogram specification may be 
  380.         modified when the specification is in statusInProgress.
  381.  
  382.         A statusCaptured or statusStopped histogram must be 
  383.         actionClear'ed before it can be restarted.
  384.  
  385.         The histogram may be read accurately between the p2mpUpdateRate
  386.         intervals. If the read spans across the update time data from 
  387.         the previous and current updates can be mingled."
  388.         ::= { p2mpHistCtrlEntry 13 }
  389.  
  390. p2mpHistRowStatus OBJECT-TYPE
  391.         SYNTAX RowStatus
  392.         MAX-ACCESS read-create
  393.         STATUS current
  394.         DESCRIPTION
  395.         "This object may be used to create or delete a histogram control
  396.         specification."
  397.         ::= { p2mpHistCtrlEntry 14 }
  398.  
  399. --
  400. --      The Histogram Summary Table. This table contains summary Data
  401. --    about the histograms collected as per the specifications in the
  402. --    p2mpHistCtrlTable.
  403. -- 
  404. --      This table MUST be supported on the head end and at the 
  405. --      subscriber unit if the p2mpHistCtrlTable is supported.
  406.  
  407. p2mpHistSummaryTable OBJECT-TYPE
  408.         SYNTAX SEQUENCE OF P2mpHistSummaryEntry
  409.         MAX-ACCESS not-accessible
  410.         STATUS current
  411.         DESCRIPTION
  412.         "This table contains histogram Summary collected based on the
  413.         specifications in the p2mpHistCtrlTable."
  414.         ::= { p2mpRadioHistoryGroup 2 }
  415.  
  416. p2mpHistSummaryEntry OBJECT-TYPE
  417.         SYNTAX P2mpHistSummaryEntry
  418.         MAX-ACCESS not-accessible
  419.         STATUS current
  420.         DESCRIPTION
  421.         "This represents one entry in the p2mpHistSummaryTable.
  422.         
  423.         At the head end:
  424.         When viewing the summary of a histogram that was created for a 
  425.         specific subscriber unit, the user must specify the subscriber 
  426.         unit's MAC address and the ifIndex of the MAC layer at the 
  427.         head end.
  428.         When viewing the summary of a histogram created for a specific 
  429.         channel, the user must set the MAC address to zero
  430.         (00 00 00 00 00 00).  The ifIndex is the upstream channel on 
  431.         which the histogram was created.
  432.  
  433.         At the subscriber end:
  434.         The user sets the MAC address (p2mpHistSuMacAdress) to 
  435.         zero(00 00 00 00 00 00). The ifIndex is the channel ID of the 
  436.         downstream channel."
  437.  
  438.         INDEX { ifIndex, p2mpHistSuMacAddress, p2mpHistClass }
  439.         ::= { p2mpHistSummaryTable 1 }
  440.  
  441.         P2mpHistSummaryEntry ::= SEQUENCE {
  442.         p2mpHistUpdateTime   CwrUpdateTime,
  443.         p2mpHistMin          CwrFixedPointValue,
  444.         p2mpHistMax          CwrFixedPointValue,
  445.         p2mpHistMean         CwrFixedPointValue 
  446.         }
  447.  
  448. p2mpHistUpdateTime OBJECT-TYPE
  449.         SYNTAX CwrUpdateTime
  450.         UNITS "seconds"
  451.         MAX-ACCESS read-only
  452.         STATUS current
  453.         DESCRIPTION
  454.         "This object represents the sysUpTime when this histogram
  455.         was retrieved from hardware."
  456.         ::= { p2mpHistSummaryEntry 1 }
  457.  
  458. p2mpHistMin OBJECT-TYPE
  459.         SYNTAX CwrFixedPointValue
  460.         MAX-ACCESS read-only
  461.         STATUS current
  462.         DESCRIPTION
  463.         "This object represents minimum value seen in this histogram."
  464.         ::= { p2mpHistSummaryEntry 2 }
  465.  
  466. p2mpHistMax OBJECT-TYPE
  467.         SYNTAX CwrFixedPointValue
  468.         MAX-ACCESS read-only
  469.         STATUS current
  470.         DESCRIPTION
  471.         "This object represents maximum value seen in this histogram."
  472.         ::= { p2mpHistSummaryEntry 3 }
  473.  
  474. p2mpHistMean OBJECT-TYPE
  475.         SYNTAX CwrFixedPointValue
  476.         MAX-ACCESS read-only
  477.         STATUS current
  478.         DESCRIPTION
  479.         "This object represents mean of the values in this histogram."
  480.         ::= { p2mpHistSummaryEntry 4 }
  481.  
  482. --
  483. --      The Histogram Data Table. This table contains the Data
  484. --    about the histograms collected as per the specifications in the
  485. --    p2mpHistCtrlTable.
  486. -- 
  487. --      This table MUST be supported on the head end and at the 
  488. --      subscriber unit if the p2mpHistCtrlTable is supported.
  489.  
  490. p2mpHistDataTable OBJECT-TYPE
  491.         SYNTAX SEQUENCE OF P2mpHistDataEntry
  492.         MAX-ACCESS not-accessible
  493.         STATUS current
  494.         DESCRIPTION
  495.         "This table contains histogram values collected based on the
  496.         specifications in the p2mpHistCtrlTable."
  497.         ::= { p2mpRadioHistoryGroup 3 }
  498.  
  499. p2mpHistDataEntry OBJECT-TYPE
  500.         SYNTAX P2mpHistDataEntry
  501.         MAX-ACCESS not-accessible
  502.         STATUS current
  503.         DESCRIPTION
  504.         "This represents one entry in the p2mpHistDataTable. 
  505.  
  506.         At the head end:
  507.         When viewing the data of a histogram that was created for a 
  508.         specific subscriber unit, the user must specify the subscriber 
  509.         unit's MAC address and the ifIndex of the MAC layer at the 
  510.         head end.
  511.         When viewing the data of a histogram created for a specific 
  512.         channel, the user must set the MAC address to zero
  513.         (00 00 00 00 00 00).  The ifIndex is the upstream channel on 
  514.         which the histogram was created.
  515.  
  516.         At the subscriber end:
  517.         The user sets the MAC address (p2mpHistSuMacAdress) to 
  518.         zero(00 00 00 00 00 00). The ifIndex is the channel ID of the 
  519.         downstream channel."
  520.  
  521.         INDEX {ifIndex, p2mpHistSuMacAddress, p2mpHistClass, 
  522.                p2mpHistBinIndex }
  523.         ::= { p2mpHistDataTable 1 }
  524.  
  525.         P2mpHistDataEntry ::= SEQUENCE {
  526.         p2mpHistBinIndex     Integer32,
  527.         p2mpValue            Integer32
  528.         }
  529.  
  530. p2mpHistBinIndex OBJECT-TYPE
  531.         SYNTAX Integer32(1..50)
  532.         MAX-ACCESS not-accessible
  533.         STATUS current
  534.         DESCRIPTION
  535.         "This object represents the histogram bin number for the value
  536.         in p2mpValue."
  537.         ::= { p2mpHistDataEntry 1 }
  538.  
  539. p2mpValue OBJECT-TYPE
  540.         SYNTAX Integer32 (0..2147483647)
  541.         MAX-ACCESS read-only
  542.         STATUS current
  543.         DESCRIPTION
  544.         "This object represents the value in the histogram bin
  545.         p2mpHistBinIndex."
  546.         ::= { p2mpHistDataEntry 2 }
  547.  
  548. --
  549. -- The Timeline Group. 
  550. --
  551. -- This group includes the following tables:
  552. -- p2mpTlCtrlTable, p2mpTlSummaryTable and p2mpTlDataTable.
  553. --
  554. -- A radio timeline is raw radio signal data captured based on the
  555. -- specifications.
  556.  
  557. p2mpTlCtrlTable OBJECT-TYPE
  558.         SYNTAX SEQUENCE OF P2mpTlCtrlEntry
  559.         MAX-ACCESS not-accessible
  560.         STATUS current
  561.         DESCRIPTION
  562.         "This table contains information about timelines configured in
  563.         hardware. When radio signal data is collected it will be stored 
  564.         in a buffer of size p2mpTlNumDataValues which may be later 
  565.         retrieved."
  566.         ::= { p2mpRadioTimelineGroup 1 }
  567.  
  568. p2mpTlCtrlEntry OBJECT-TYPE
  569.         SYNTAX P2mpTlCtrlEntry
  570.         MAX-ACCESS not-accessible
  571.         STATUS current
  572.         DESCRIPTION
  573.         "This represents one entry in the p2mpTlCtrlTable.  This table
  574.         is indexed by ifIndex, p2mpTlSuMacAddress, and p2mpTlClass.
  575.  
  576.         At the head end:
  577.         Timelines can be created on each upstream channel either on a
  578.         per channel or per subscriber unit basis.
  579.         
  580.         When timelines are created on a per subscriber unit basis, the 
  581.         user must specify the subscriber unit's MAC address and the 
  582.         ifIndex of the MAC layer (propDocsWirelessMaclayer) at the 
  583.         head end.
  584.  
  585.         When timelines are created on a per channel basis, the user
  586.         must set the MAC address to zero(00 00 00 00 00 00).  The channel
  587.         ID is specified by the ifIndex of the upstream channel.  Hence,
  588.         when creating timelines on a per channel basis, the ifIndex must
  589.         be set to the ifIndex of the upstream channel on which the 
  590.         timeline is to be created
  591.  
  592.         At the subscriber end:
  593.         Timelines can only be created on the downstream channel.  Since 
  594.         there is only one downstream channel, timelines cannot be 
  595.         created per channel ID.  Hence, when a timeline is created, the  
  596.         user must set the MAC address (p2mpTlSuMacAdress) to
  597.         zero(00 00 00 00 00 00).  The ifIndex must be set to the ifIndex
  598.         of the downstream channel (propDocsWirelessDownstream)."
  599.  
  600.         INDEX { ifIndex, p2mpTlSuMacAddress, p2mpTlClass}
  601.         ::= { p2mpTlCtrlTable 1 }
  602.  
  603. P2mpTlCtrlEntry ::= SEQUENCE {
  604.         p2mpTlSuMacAddress       MacAddress,
  605.         p2mpTlClass              P2mpRadioSignalAttribute,
  606.         p2mpTlThreshAttribute    P2mpRadioSignalAttribute,
  607.         p2mpTlThreshType         CwrThreshLimitType,
  608.         p2mpTlNumDataValues      Integer32,
  609.         p2mpTlDataScale          CwrFixedPointScale,
  610.         p2mpTlDataPrecision      CwrFixedPointPrecision,
  611.         p2mpTlSamplePeriod       Integer32,
  612.         p2mpTlAction             CwrCollectionAction,
  613.         p2mpTlPostTrigBufMgmt    INTEGER,
  614.         p2mpTlOwner              OwnerString,
  615.         p2mpTlStatus             CwrCollectionStatus,
  616.         p2mpTlRowStatus          RowStatus
  617.         }
  618.  
  619. p2mpTlSuMacAddress OBJECT-TYPE
  620.         SYNTAX MacAddress
  621.         MAX-ACCESS not-accessible
  622.         STATUS current
  623.         DESCRIPTION
  624.         "This object is used to index this table.
  625.         At the head end:
  626.            When a timeline is created on a per subscriber unit basis,
  627.            this object should reflect the MAC address of the subscriber 
  628.            unit.
  629.            When a timeline is created on a per channel basis, this object
  630.            must be set to zero(00 00 00 00 00 00).
  631.  
  632.         At the subscriber end:
  633.            When creating a timeline, this object must always be set to 
  634.            zero (00 00 00 00 00 00)."
  635.         ::= { p2mpTlCtrlEntry 1 }
  636.  
  637. p2mpTlClass OBJECT-TYPE
  638.         SYNTAX P2mpRadioSignalAttribute
  639.         MAX-ACCESS not-accessible
  640.         STATUS current
  641.         DESCRIPTION
  642.         "This object represents the attribute for which a timline capture
  643.         is requested.
  644.         When a timeline is requested p2mpBufSize worth of data will be
  645.         captured."
  646.         ::= { p2mpTlCtrlEntry 2 }
  647.  
  648. p2mpTlThreshAttribute OBJECT-TYPE
  649.         SYNTAX  P2mpRadioSignalAttribute
  650.         MAX-ACCESS read-create
  651.         STATUS current
  652.         DESCRIPTION
  653.         "This object, along with p2mpTlThreshType, identifies the 
  654.         threshold in the p2mpThresholdTable responsible for trigerring 
  655.         this timeline. When this object's value is none(0), it implies 
  656.         that there is no threshold associated with this timeline."
  657.         ::= { p2mpTlCtrlEntry 3 }
  658.  
  659. p2mpTlThreshType OBJECT-TYPE
  660.         SYNTAX CwrThreshLimitType
  661.         MAX-ACCESS read-create
  662.         STATUS current
  663.         DESCRIPTION
  664.         "This object, along with p2mpTlThreshAttribute, identifies the 
  665.         threshold in the p2mpThresholdTable responsible for trigerring 
  666.         this timeline.  When this object's value is none(0), it implies 
  667.         that there is no threshold associated with this timeline."
  668.         ::= { p2mpTlCtrlEntry 4 }
  669.  
  670. p2mpTlNumDataValues OBJECT-TYPE
  671.         SYNTAX Integer32(1..2147483647)
  672.         UNITS "number of data values"
  673.         MAX-ACCESS read-create
  674.         STATUS current
  675.         DESCRIPTION
  676.         "This object indicates the number of data values to be captured 
  677.         for this timeline.  The captured data can be viewed by reading 
  678.         the p2mpTlDataTable."
  679.         ::= { p2mpTlCtrlEntry 5 }
  680.  
  681. p2mpTlDataScale OBJECT-TYPE
  682.         SYNTAX        CwrFixedPointScale
  683.         MAX-ACCESS    read-only
  684.         STATUS        current
  685.         DESCRIPTION
  686.         "This variable indicates the exponent to apply to the
  687.         fixed-point values in the timeline data table."
  688.         ::= { p2mpTlCtrlEntry 6 }
  689.  
  690. p2mpTlDataPrecision OBJECT-TYPE
  691.         SYNTAX        CwrFixedPointPrecision
  692.         MAX-ACCESS    read-only
  693.         STATUS        current
  694.         DESCRIPTION
  695.         "This variable indicates the number of decimal places used for 
  696.         precision when interpreting the fixed-point values in the 
  697.         timeline data table."
  698.         ::= { p2mpTlCtrlEntry 7 }
  699.  
  700. p2mpTlSamplePeriod OBJECT-TYPE
  701.         SYNTAX Integer32(0..2147483647)
  702.     UNITS "milliseconds"
  703.         MAX-ACCESS read-create
  704.         STATUS current
  705.         DESCRIPTION
  706.         "This lets the user specify the time in milliseconds between
  707.         consecutive timeline samples.
  708.         The special value of '0' indicates that the timeline will be 
  709.         sampled on every burst of data.  The number of bursts in one
  710.         milliseconds depends on the modulation profile."
  711.         ::= { p2mpTlCtrlEntry 8 }
  712.  
  713. p2mpTlAction OBJECT-TYPE
  714.         SYNTAX CwrCollectionAction
  715.         MAX-ACCESS read-create
  716.         STATUS current
  717.         DESCRIPTION
  718.         "This object represents the action to be carried out on this
  719.         timeline specification. If a timeline has been successfully
  720.         captured then it must be cleared before another capture
  721.         may be initiated."
  722.         ::= { p2mpTlCtrlEntry 9 }
  723.  
  724. p2mpTlPostTrigBufMgmt OBJECT-TYPE
  725.         SYNTAX INTEGER {
  726.                 preTrigger(1),
  727.                 postTrigger(2)
  728.         }
  729.         MAX-ACCESS read-create
  730.         STATUS current
  731.         DESCRIPTION
  732.         "Once a trigger fires, this object determines which portion of 
  733.         the collected data to capture for use. If it is:
  734.         preTrigger(1) : Then most of the data collected prior to trigger
  735.                         is captured.
  736.         postTrigger(2): Then most of the data collected after the trigger
  737.                         is captured."
  738.         ::= { p2mpTlCtrlEntry 10 }
  739.  
  740. p2mpTlOwner OBJECT-TYPE
  741.         SYNTAX OwnerString
  742.         MAX-ACCESS read-create
  743.         STATUS current
  744.         DESCRIPTION
  745.     "This object identifies the management station that created this
  746.     timeline specification."
  747.         ::= { p2mpTlCtrlEntry 11 }
  748.  
  749. p2mpTlStatus OBJECT-TYPE
  750.         SYNTAX CwrCollectionStatus
  751.         MAX-ACCESS read-only
  752.         STATUS current
  753.         DESCRIPTION
  754.         "This object represents the current state of this timeline. 
  755.         Once the timeline collection is complete the status changes to
  756.         statusCaptured and the data is available for use.
  757.         None of the parameters of a timeline specification may be 
  758.         modified when the specification is in statusInProgress.
  759.  
  760.         A statusCaptured or statusStopped timeline must be actionClear'ed
  761.         before it can be restarted."
  762.         ::= { p2mpTlCtrlEntry 12 }
  763.  
  764. p2mpTlRowStatus OBJECT-TYPE
  765.         SYNTAX RowStatus
  766.         MAX-ACCESS read-create
  767.         STATUS current
  768.         DESCRIPTION
  769.         "This object may be used to create or delete a timeline control
  770.         specification.  Once created data sampling starts based on the
  771.         value of p2mpTlAction."
  772.         ::= { p2mpTlCtrlEntry 13 }
  773.  
  774.  
  775. --
  776. --      The Timeline Summary Table. This table contains summary Data
  777. --      about the timeline collected as per the specifications in the
  778. --      p2mpTlCtrlTable.
  779. --
  780.  
  781. p2mpTlSummaryTable OBJECT-TYPE
  782.         SYNTAX SEQUENCE OF P2mpTlSummaryEntry
  783.         MAX-ACCESS not-accessible
  784.         STATUS current
  785.         DESCRIPTION
  786.         "This table contains Timeline Summary collected based on the
  787.         specifications in the p2mpTlCtrlTable."
  788.         ::= { p2mpRadioTimelineGroup 2 }
  789.  
  790. p2mpTlSummaryEntry OBJECT-TYPE
  791.         SYNTAX P2mpTlSummaryEntry
  792.         MAX-ACCESS not-accessible
  793.         STATUS current
  794.         DESCRIPTION
  795.         "This represents one entry in the p2mpTlSummaryTable.
  796.         
  797.         At the head end:
  798.         When viewing the summary of a timeline created for a specific 
  799.         subscriber unit, the user must specify the subscriber unit's 
  800.         MAC address and the ifIndex of the MAC layer at the head end. 
  801.         When viewing the summary of a timeline created for a specific 
  802.         channel, the user must set the MAC address to 
  803.         zero(00 00 00 00 00 00).  The ifIndex is the upstream channel on
  804.         which the timeline was created.
  805.  
  806.         At the subscriber end:
  807.         The user sets the MAC address (p2mpTlSuMacAdress) to 
  808.         zero(00 00 00 00 00 00). The ifIndex is the channel ID of the 
  809.         downstream channel."
  810.  
  811.         INDEX { ifIndex, p2mpTlSuMacAddress, p2mpTlClass}
  812.         ::= { p2mpTlSummaryTable 1 }
  813.  
  814. P2mpTlSummaryEntry ::= SEQUENCE {
  815.         p2mpTlUpdateTime         CwrUpdateTime,
  816.         p2mpTlNumValues          Integer32,
  817.         p2mpTlTriggerLoc         Integer32
  818.         }
  819.  
  820. p2mpTlUpdateTime OBJECT-TYPE
  821.         SYNTAX CwrUpdateTime
  822.         UNITS "seconds"
  823.         MAX-ACCESS read-only
  824.         STATUS current
  825.         DESCRIPTION
  826.         "This object represents the sysUpTime when this timeline
  827.         capture was completed."
  828.         ::= { p2mpTlSummaryEntry 1 }
  829.  
  830. p2mpTlNumValues OBJECT-TYPE
  831.         SYNTAX Integer32 (0..2147483647)
  832.         MAX-ACCESS read-only
  833.         STATUS current
  834.         DESCRIPTION
  835.         "This object represents the number of values available in the 
  836.         timeline"
  837.         ::= { p2mpTlSummaryEntry 2 }
  838.  
  839. p2mpTlTriggerLoc OBJECT-TYPE
  840.         SYNTAX Integer32 (0..2147483647)
  841.         MAX-ACCESS read-only
  842.         STATUS current
  843.         DESCRIPTION
  844.         "This object contains the value of p2mpTlValueIndex which 
  845.         represents the entry in the p2mpTlDataTable that caused the stop
  846.         trigger to fire, thereby resulting in this timeline to be 
  847.         collected."
  848.         ::= { p2mpTlSummaryEntry 3 }
  849.  
  850.  
  851. --
  852. --      The Timeline Data Table. This table contains the Data
  853. --      about the timelines collected as per the specifications in the
  854. --      p2mpTlCtrlTable.
  855. --
  856.  
  857. p2mpTlDataTable OBJECT-TYPE
  858.         SYNTAX SEQUENCE OF P2mpTlDataEntry
  859.         MAX-ACCESS not-accessible
  860.         STATUS current
  861.         DESCRIPTION
  862.         "This table contains timeline values collected based on the
  863.         specifications in the p2mpTlCtrlTable."
  864.         ::= { p2mpRadioTimelineGroup 3 }
  865.  
  866. p2mpTlDataEntry OBJECT-TYPE
  867.         SYNTAX P2mpTlDataEntry
  868.         MAX-ACCESS not-accessible
  869.         STATUS current
  870.         DESCRIPTION
  871.         "This represents one entry in the p2mpTlDataTable. 
  872.  
  873.         At the head end:
  874.         When viewing the data of a timeline created for a specific
  875.         subscriber unit, the user must specify the subscriber unit's 
  876.         MAC address and the ifIndex of the MAC layer at the head end.
  877.  
  878.         When viewing the data of a timeline created for a specific 
  879.         channel, the user must set the MAC address to 
  880.         zero(00 00 00 00 00 00).  The ifIndex is the upstream channel
  881.         on which the timeline was created.
  882.  
  883.         At the subscriber end:
  884.         The user sets the MAC address (p2mpTlSuMacAdress) to 
  885.         zero(00 00 00 00 00 00). The ifIndex is the channel ID of the 
  886.         downstream channel."
  887.  
  888.         INDEX { ifIndex, p2mpTlSuMacAddress, p2mpTlClass, p2mpTlValueIndex}
  889.         ::= { p2mpTlDataTable 1 }
  890.  
  891. P2mpTlDataEntry ::= SEQUENCE {
  892.         p2mpTlValueIndex         Integer32,
  893.         p2mpTlValue              CwrFixedPointValue
  894.         }
  895.  
  896. p2mpTlValueIndex OBJECT-TYPE
  897.         SYNTAX Integer32 (1..2147483647)
  898.         MAX-ACCESS not-accessible
  899.         STATUS current
  900.         DESCRIPTION
  901.         "This object is the index into the timeline data."
  902.         ::= { p2mpTlDataEntry 1 }
  903.  
  904. p2mpTlValue OBJECT-TYPE
  905.         SYNTAX CwrFixedPointValue
  906.         MAX-ACCESS read-only
  907.         STATUS current
  908.         DESCRIPTION
  909.         "This object represents the radio signal data sampled."
  910.         ::= { p2mpTlDataEntry 2 }
  911.  
  912.  
  913. --
  914. -- The Threshold table. This table enables the user to define thresholds.
  915. -- 
  916.  
  917. p2mpThresholdTable OBJECT-TYPE
  918.         SYNTAX SEQUENCE OF P2mpThresholdEntry
  919.         MAX-ACCESS not-accessible
  920.         STATUS current
  921.         DESCRIPTION
  922.         "This table enables the user to establish thresholds for the 
  923.         radio signals analyzed on the radio interface." 
  924.         ::= { p2mpRadioThresholdGroup 1 }
  925.  
  926.  
  927. p2mpThresholdEntry OBJECT-TYPE
  928.         SYNTAX P2mpThresholdEntry
  929.         MAX-ACCESS not-accessible
  930.         STATUS current
  931.         DESCRIPTION
  932.         "This represents one entry in the p2mpThresholdTable.
  933.  
  934.         At the head end:
  935.         Thresholds can be created on each upstream channel either on a
  936.         per channel or per subscriber unit basis.
  937.         
  938.         When creating thresholds on a per subscriber unit basis, the 
  939.         user must specify the subscriber unit's MAC address and the 
  940.         ifIndex of the MAC layer (propDocsWirelessMaclayer) at the 
  941.         head end.
  942.  
  943.         When creating thresholds on a per channel basis, the user
  944.         must set the MAC address to zero(00 00 00 00 00 00).  The channel
  945.         ID is specified by the ifIndex of the upstream channel.  Hence,
  946.         when creating thresholds on a per channel basis, the ifIndex must
  947.         be set to the ifIndex of the upstream channel
  948.         (propDocsWirelessUpstream) on which the threshold is created.  
  949.  
  950.         At the subscriber end:
  951.         Thresholds can only be created on the downstream channel.  Since 
  952.         there is only one downstream channel, thresholds cannot be 
  953.         created per channel ID.  Hence, when a thresholds is created, the
  954.         users sets the MAC address (p2mpThreshSuMacAdress) to 
  955.         zero(00 00 00 00 00 00).  The ifIndex must be set to the ifIndex
  956.         of the downstream channel (propDocsWirelessDownstream)."  
  957.  
  958.         INDEX {ifIndex,p2mpThreshSuMacAddr,p2mpThreshAttribute,p2mpThreshType}
  959.         ::= { p2mpThresholdTable 1 }
  960.  
  961. P2mpThresholdEntry ::= SEQUENCE {
  962.     p2mpThreshSuMacAddr          MacAddress,
  963.         p2mpThreshAttribute          P2mpRadioSignalAttribute,
  964.         p2mpThreshType               CwrThreshLimitType,
  965.         p2mpThreshValue              Integer32,
  966.         p2mpThreshHysteresisTime     TimeInterval,
  967.         p2mpThreshLimitTime          TimeInterval,
  968.         p2mpThreshRowStatus          RowStatus
  969.         }
  970.  
  971. p2mpThreshSuMacAddr    OBJECT-TYPE
  972.         SYNTAX MacAddress
  973.         MAX-ACCESS not-accessible
  974.         STATUS current
  975.         DESCRIPTION
  976.         "This object is used to index this table.
  977.  
  978.         At the head end:
  979.            When a threshold is created on a per subscriber unit basis,
  980.            this object should reflect the MAC address of the subscriber 
  981.            unit.
  982.            When a threshold is created on a per channel basis, this 
  983.            object must be set to zero(00 00 00 00 00 00).
  984.         At the subscriber end:
  985.            When creating a threshold , this object must always be set
  986.            to zero (00 00 00 00 00 00)."
  987.         ::= { p2mpThresholdEntry 1 }
  988.  
  989. p2mpThreshAttribute OBJECT-TYPE
  990.         SYNTAX  P2mpRadioSignalAttribute
  991.         MAX-ACCESS not-accessible
  992.         STATUS current
  993.         DESCRIPTION
  994.         "This represents the attribute of a radio link which needs to be
  995.         thresholded. For each of these attributes, the p2mpThreshType 
  996.         identifies the type of change to monitor. When that threshold is
  997.         exceeded a Trap with appropriate parameters will be generated."
  998.         ::= { p2mpThresholdEntry 2 }
  999.  
  1000. p2mpThreshType OBJECT-TYPE
  1001.         SYNTAX CwrThreshLimitType
  1002.         MAX-ACCESS not-accessible
  1003.         STATUS current
  1004.         DESCRIPTION
  1005.         "This object represents the kind of change that needs to be 
  1006.         monitored for the p2mpThreshAttribute. An event is generated
  1007.         when the specified condition is met."
  1008.         ::= { p2mpThresholdEntry 3 }
  1009.  
  1010. p2mpThreshValue OBJECT-TYPE
  1011.         SYNTAX Integer32 (-2147483647..2147483647)
  1012.         MAX-ACCESS read-create
  1013.         STATUS current
  1014.         DESCRIPTION
  1015.         "This object represents the value to be compared against. The
  1016.         p2mpThreshType determines the way in which it is used.
  1017.         It is used as follows:
  1018.         if p2mpThreshType is ..
  1019.         highThresh : Notify if data sample exceeds the p2mpThreshValue.
  1020.         lowThresh  : Notify if data sample recedes below the 
  1021.                      p2mpThreshValue.
  1022.         upChange   : Notify if data sample increases by more than
  1023.                      p2mpThreshValue.
  1024.         downChange : Notify if data sample decreases by more than
  1025.                      p2mpThreshValue.
  1026.         upLimit    : Notify if data sample crosses p2mpThreshValue while
  1027.                      increasing in value.
  1028.         lowLimit   : Notify if data sample crosses p2mpThreshValue while
  1029.                      decreasing in value."
  1030.         ::= { p2mpThresholdEntry 4 }
  1031.  
  1032. p2mpThreshHysteresisTime OBJECT-TYPE
  1033.         SYNTAX TimeInterval
  1034.         MAX-ACCESS read-create
  1035.         STATUS current
  1036.         DESCRIPTION
  1037.         "When radio signals oscillate around threshold values, they 
  1038.         potentially flood the system with notifications. This object 
  1039.         specifies the amount of time to wait before sending an identical
  1040.         notification if the oscillations continue."
  1041.         ::= { p2mpThresholdEntry 5 }
  1042.  
  1043. p2mpThreshLimitTime OBJECT-TYPE
  1044.         SYNTAX TimeInterval
  1045.         MAX-ACCESS read-create
  1046.         STATUS current
  1047.         DESCRIPTION
  1048.         "It is desirable to know when a radio signal has stabilized. This
  1049.         object specifies the amount of time that the radio signal should
  1050.         stay below the threshold after crossing it. If it does then a 
  1051.         'clear' notification is sent."
  1052.         ::= { p2mpThresholdEntry 6 }
  1053.  
  1054. p2mpThreshRowStatus OBJECT-TYPE
  1055.         SYNTAX RowStatus
  1056.         MAX-ACCESS read-create
  1057.         STATUS current
  1058.         DESCRIPTION
  1059.         "This object represents the status of this threshold entry. It 
  1060.         may be used to create a new threshold specification.
  1061.         For every p2mpThreshAttribute one threshold of p2mpThreshType on
  1062.         one DSP may be created."
  1063.         ::= { p2mpThresholdEntry 7 }
  1064.  
  1065. --
  1066. --  This table enables the user to capture upto 4 synchronized 
  1067. --  raw radio signal attributes simultaneously.  The user initiates the
  1068. --  snapshot capture by setting p2mpSnapshotAction to 'actionStart'
  1069. --
  1070. --  Some attributes in this group are represented by complex numbers
  1071. --  Each such attribute is indicated as value(I, q).
  1072. --
  1073.  
  1074. p2mpSnapshotCtrlTable OBJECT-TYPE
  1075.         SYNTAX SEQUENCE OF P2mpSnapshotCtrlEntry
  1076.         MAX-ACCESS not-accessible
  1077.         STATUS current
  1078.         DESCRIPTION
  1079.         "This table contains information about the snapshots configured 
  1080.         in hardware. When data is collected it will be stored in
  1081.         p2mpSnapDataTable. Snapshots can only be captured per DSP."
  1082.         ::= { p2mpRadioSnapshotGroup 1 }
  1083.  
  1084. p2mpSnapshotCtrlEntry OBJECT-TYPE
  1085.         SYNTAX P2mpSnapshotCtrlEntry
  1086.         MAX-ACCESS not-accessible
  1087.         STATUS current
  1088.         DESCRIPTION
  1089.         "This represents one entry in the p2mpSnapshotCntrlTable
  1090.         It is indexed by the ifIndex of the MAC layer 
  1091.         (propDocsWirelessMaclayer) and p2mpSnapshotDspNum."
  1092.         INDEX { ifIndex, p2mpSnapshotDspNum}
  1093.         ::= { p2mpSnapshotCtrlTable 1 }
  1094.  
  1095. P2mpSnapshotCtrlEntry ::= SEQUENCE {
  1096.         p2mpSnapshotDspNum           Integer32,
  1097.         p2mpSnapshotType             P2mpSnapshotAttribute,
  1098.         p2mpSnapshotDataScale        CwrFixedPointScale,
  1099.         p2mpSnapshotDataPrecision    CwrFixedPointPrecision,
  1100.     p2mpSnapshotOwner            OwnerString,
  1101.         p2mpSnapshotAction           CwrCollectionAction,
  1102.         p2mpSnapshotStatus           CwrCollectionStatus,
  1103.         p2mpSnapshotRowStatus        RowStatus
  1104.         }
  1105.  
  1106. p2mpSnapshotDspNum OBJECT-TYPE
  1107.         SYNTAX Integer32(1..8)
  1108.         MAX-ACCESS not-accessible
  1109.         STATUS current
  1110.         DESCRIPTION
  1111.         "This object represents the DSP on which the snapshot needs to
  1112.         be collected."
  1113.         ::= { p2mpSnapshotCtrlEntry 1 }
  1114.  
  1115. p2mpSnapshotType OBJECT-TYPE
  1116.         SYNTAX P2mpSnapshotAttribute
  1117.         MAX-ACCESS read-create
  1118.         STATUS current
  1119.         DESCRIPTION
  1120.         "This identfies the set of radio signal attributes being 
  1121.         monitored in this snapshot."
  1122.         ::= { p2mpSnapshotCtrlEntry 2 }
  1123.  
  1124. p2mpSnapshotDataScale OBJECT-TYPE
  1125.         SYNTAX        CwrFixedPointScale
  1126.         MAX-ACCESS    read-only
  1127.         STATUS        current
  1128.         DESCRIPTION
  1129.         "This variable indicates the exponent to apply to the 
  1130.         fixed-point values in the snapshot data table."
  1131.         ::= { p2mpSnapshotCtrlEntry 3 }
  1132.  
  1133. p2mpSnapshotDataPrecision OBJECT-TYPE
  1134.         SYNTAX        CwrFixedPointPrecision
  1135.         MAX-ACCESS    read-only
  1136.         STATUS        current
  1137.         DESCRIPTION
  1138.         "This variable indicates the number of decimal places used for 
  1139.         precision when interpreting the fixed-point values in the 
  1140.         snapshot data table."
  1141.         ::= { p2mpSnapshotCtrlEntry 4 }
  1142.  
  1143. p2mpSnapshotOwner OBJECT-TYPE
  1144.         SYNTAX OwnerString
  1145.         MAX-ACCESS read-create
  1146.         STATUS current
  1147.         DESCRIPTION
  1148.     "This object identifies management station that created this
  1149.     snapshot specification."
  1150.         ::= { p2mpSnapshotCtrlEntry 5 }
  1151.  
  1152. p2mpSnapshotAction OBJECT-TYPE
  1153.         SYNTAX CwrCollectionAction
  1154.         MAX-ACCESS read-create
  1155.         STATUS current
  1156.         DESCRIPTION
  1157.         "This object represents the action to be carried out on this
  1158.         snapshot specification. If a snapshot has been successfully
  1159.         captured then it must be cleared before another capture
  1160.         may be initiated."
  1161.         ::= { p2mpSnapshotCtrlEntry 6 }
  1162.  
  1163. p2mpSnapshotStatus OBJECT-TYPE
  1164.         SYNTAX CwrCollectionStatus
  1165.         MAX-ACCESS read-only
  1166.         STATUS current
  1167.         DESCRIPTION
  1168.         "This object represents the current status of this snapshot
  1169.         specification. When the status in statusInProgress none of the
  1170.         snapshot parameters can be configured. When the status is
  1171.         statusCaptured then data is available for use."
  1172.         ::= { p2mpSnapshotCtrlEntry 7 }
  1173.  
  1174. p2mpSnapshotRowStatus OBJECT-TYPE
  1175.         SYNTAX RowStatus
  1176.         MAX-ACCESS read-create
  1177.         STATUS current
  1178.         DESCRIPTION
  1179.         "This object may be used to create or delete this snapshot
  1180.         specification."
  1181.         ::= { p2mpSnapshotCtrlEntry 8 }
  1182.  
  1183. --
  1184. --      The Snapshot Summary Table. This table contains summary 
  1185. --      information for the data captured by a snapshot specification
  1186. --
  1187. --  This table is supported on the head end and at the subscriber unit.
  1188.  
  1189. p2mpSnapSummaryTable OBJECT-TYPE
  1190.         SYNTAX SEQUENCE OF P2mpSnapSummaryEntry
  1191.         MAX-ACCESS not-accessible
  1192.         STATUS current
  1193.         DESCRIPTION
  1194.         "This table contains summary information for captured snapshots
  1195.         defined in p2mpSnapshotCtrlTable."
  1196.         ::= { p2mpRadioSnapshotGroup 2 }
  1197.  
  1198. p2mpSnapSummaryEntry OBJECT-TYPE
  1199.         SYNTAX P2mpSnapSummaryEntry
  1200.         MAX-ACCESS not-accessible
  1201.         STATUS current
  1202.         DESCRIPTION
  1203.         "This represents one entry in the p2mpSnapSummaryTable. It is 
  1204.         indexed by the ifIndex of the MAC layer 
  1205.         (propDocsWirelessMaclayer) and p2mpSnapshotDspNum."
  1206.         INDEX { ifIndex, p2mpSnapshotDspNum}
  1207.         ::= { p2mpSnapSummaryTable 1 }
  1208.  
  1209. P2mpSnapSummaryEntry ::= SEQUENCE {
  1210.         p2mpSnapAttr1Id          Integer32,
  1211.         p2mpSnapAttr1Size        Integer32,
  1212.         p2mpSnapAttr2Id          Integer32,
  1213.         p2mpSnapAttr2Size        Integer32,
  1214.         p2mpSnapAttr3Id          Integer32,
  1215.         p2mpSnapAttr3Size        Integer32,
  1216.         p2mpSnapAttr4Id          Integer32,
  1217.         p2mpSnapAttr4Size        Integer32
  1218.         }
  1219.  
  1220. p2mpSnapAttr1Id OBJECT-TYPE
  1221.         SYNTAX Integer32 (1..2147483647)
  1222.         MAX-ACCESS read-only
  1223.         STATUS current
  1224.         DESCRIPTION
  1225.         "This object represents the bit in the P2mpSnapshotAttribute
  1226.         bitmask that identifies the first attribute value."
  1227.         ::= { p2mpSnapSummaryEntry 2 }
  1228.  
  1229. p2mpSnapAttr1Size OBJECT-TYPE
  1230.         SYNTAX Integer32 (0..4096)
  1231.         MAX-ACCESS read-only
  1232.         STATUS current
  1233.         DESCRIPTION
  1234.         "This object represents the number of values captured for the 
  1235.         snapshot p2mpSnapAttr1Id."
  1236.         ::= { p2mpSnapSummaryEntry 3 }
  1237.  
  1238. p2mpSnapAttr2Id OBJECT-TYPE
  1239.         SYNTAX Integer32 (1..2147483647)
  1240.         MAX-ACCESS read-only
  1241.         STATUS current
  1242.         DESCRIPTION
  1243.         "This object represents the bit in the P2mpSnapshotAttribute
  1244.         bitmask that identifies the second attribute value."
  1245.         ::= { p2mpSnapSummaryEntry 4 }
  1246.  
  1247. p2mpSnapAttr2Size OBJECT-TYPE
  1248.         SYNTAX Integer32 (0..4096)
  1249.         MAX-ACCESS read-only
  1250.         STATUS current
  1251.         DESCRIPTION
  1252.         "This object represents the number of values captured for the 
  1253.         snapshot p2mpSnapAttr2Id."
  1254.         ::= { p2mpSnapSummaryEntry 5 }
  1255.  
  1256. p2mpSnapAttr3Id OBJECT-TYPE
  1257.         SYNTAX Integer32 (1..2147483647)
  1258.         MAX-ACCESS read-only
  1259.         STATUS current
  1260.         DESCRIPTION
  1261.         "This object represents the bit in the P2mpSnapshotAttribute
  1262.         bitmask that identifies the third attribute value."
  1263.         ::= { p2mpSnapSummaryEntry 6 }
  1264.  
  1265. p2mpSnapAttr3Size OBJECT-TYPE
  1266.         SYNTAX Integer32 (0..4096)
  1267.         MAX-ACCESS read-only
  1268.         STATUS current
  1269.         DESCRIPTION
  1270.         "This object represents the number of values captured for the 
  1271.         snapshot p2mpSnapAttr3Id."
  1272.         ::= { p2mpSnapSummaryEntry 7 }
  1273.  
  1274. p2mpSnapAttr4Id OBJECT-TYPE
  1275.         SYNTAX Integer32 (1..2147483647)
  1276.         MAX-ACCESS read-only
  1277.         STATUS current
  1278.         DESCRIPTION
  1279.         "This object represents the bit in the P2mpSnapshotAttribute
  1280.         bitmask that identifies the fourth attribute value."
  1281.         ::= { p2mpSnapSummaryEntry 8 }
  1282.  
  1283. p2mpSnapAttr4Size OBJECT-TYPE
  1284.         SYNTAX Integer32 (0..4096)
  1285.         MAX-ACCESS read-only
  1286.         STATUS current
  1287.         DESCRIPTION
  1288.         "This object represents the number of values captured for the 
  1289.         snapshot p2mpSnapAttr4Id."
  1290.         ::= { p2mpSnapSummaryEntry 9 }
  1291.  
  1292.  
  1293. --
  1294. --      The Snapshot Data Table. This table contains the Data
  1295. --      about the snapshots collected as per the specifications in the
  1296. --      p2mpSnapshotCtrlTable.
  1297. --
  1298. --  This table is supported on the head end and at the subscriber unit.
  1299.  
  1300. p2mpSnapDataTable OBJECT-TYPE
  1301.         SYNTAX SEQUENCE OF P2mpSnapDataEntry
  1302.         MAX-ACCESS not-accessible
  1303.         STATUS current
  1304.         DESCRIPTION
  1305.         "This table contains snapshot values collected based on the
  1306.         specifications in the p2mpSnapshotCtrlTable."
  1307.         ::= { p2mpRadioSnapshotGroup 3 }
  1308.  
  1309. p2mpSnapDataEntry OBJECT-TYPE
  1310.         SYNTAX P2mpSnapDataEntry
  1311.         MAX-ACCESS not-accessible
  1312.         STATUS current
  1313.         DESCRIPTION
  1314.         "This represents one entry in the P2mpSnapDataTable. It is 
  1315.         indexed by ifIndex of the MAC layer (propDocsWirelessMaclayer), 
  1316.         p2mpSnapshotIndex, and p2mpSnapValueIndex.
  1317.  
  1318.         The values in this table represent real and complex numbers.
  1319.         If they are real numbers then p2mpRealPart contains the data and
  1320.         p2mpImaginaryPart is undefined."
  1321.         INDEX { ifIndex, p2mpSnapshotDspNum, p2mpSnapValueIndex }
  1322.         ::= { p2mpSnapDataTable 1 }
  1323.  
  1324. P2mpSnapDataEntry ::= SEQUENCE {
  1325.         p2mpSnapValueIndex        Integer32,
  1326.         p2mpRealPart              CwrFixedPointValue,
  1327.         p2mpImaginaryPart         CwrFixedPointValue
  1328.         }
  1329.  
  1330. p2mpSnapValueIndex OBJECT-TYPE
  1331.         SYNTAX Integer32(1..4096)
  1332.         MAX-ACCESS not-accessible
  1333.         STATUS current
  1334.         DESCRIPTION
  1335.         "This object represents the snapshot entry value number.  The 
  1336.         hardware provides a maximum of 1024 data points for any snapshot
  1337.         attribute.  Since we can capture a maximum of 4 attributes in a 
  1338.         single snapshot, this object can have a maximum value of 
  1339.         4096 (1024 * 4)."
  1340.         ::= { p2mpSnapDataEntry 1 }
  1341.  
  1342. p2mpRealPart OBJECT-TYPE
  1343.         SYNTAX CwrFixedPointValue
  1344.         MAX-ACCESS read-only
  1345.         STATUS current
  1346.         DESCRIPTION
  1347.         "The data sample value. Real part."
  1348.         ::= { p2mpSnapDataEntry 2 }
  1349.  
  1350.  
  1351. p2mpImaginaryPart OBJECT-TYPE
  1352.         SYNTAX CwrFixedPointValue
  1353.         MAX-ACCESS read-only
  1354.         STATUS current
  1355.         DESCRIPTION
  1356.         "The data sample value. Imaginary part of the attribute is 
  1357.         represented by a complex number."
  1358.         ::= { p2mpSnapDataEntry 3 }
  1359.  
  1360.  
  1361. -- The following two OBJECT IDENTIFIERS are used to define SNMPv2
  1362. -- Notifications that are backward compatible with SNMPv1 Traps.
  1363.  
  1364. p2mpRfMetricsMIBNotificationPrefix  
  1365.                 OBJECT IDENTIFIER ::= { p2mpRadioThresholdGroup 2 }
  1366. p2mpRfMetricsMIBNotification 
  1367.             OBJECT IDENTIFIER ::= {p2mpRfMetricsMIBNotificationPrefix 0}
  1368.  
  1369. --
  1370. -- The following trap is generated in response to a threshold defined
  1371. -- in p2mpThreshTable.  
  1372.  
  1373. p2mpTrapThresh NOTIFICATION-TYPE
  1374.     OBJECTS {p2mpThreshValue, 
  1375.                  p2mpThreshHysteresisTime, 
  1376.                  p2mpThreshLimitTime }
  1377.         STATUS current
  1378.         DESCRIPTION
  1379.         "The radio subsystem generates this trap when a threshold crosses
  1380.         its specified limit. The parameters identify the following:
  1381.         p2mpThreshValue          - The value that was crossed.
  1382.         p2mpThreshHysteresisTime - The specified hysteresis time 
  1383.         p2mpThreshLimitTime      - The specified limit time "
  1384.         ::= { p2mpRfMetricsMIBNotification 1 }
  1385.  
  1386.  
  1387.  
  1388. -- ============================================================================
  1389. --
  1390. -- Compliance Statements
  1391. --
  1392.  
  1393. p2mpRadioRfConformance 
  1394.                     OBJECT IDENTIFIER ::= {ciscoWirelessRfMetricsMIB 5}
  1395. p2mpRadioRfCompliances OBJECT IDENTIFIER ::= { p2mpRadioRfConformance 1 }
  1396. p2mpRadioRfGroups      OBJECT IDENTIFIER ::= { p2mpRadioRfConformance 2 }
  1397.  
  1398. p2mpRadioRfCompliance MODULE-COMPLIANCE
  1399.         STATUS      current
  1400.         DESCRIPTION
  1401.             "The compliance statement for devices that are Point to 
  1402.             MultiPoint wireless interfaces."
  1403.  
  1404.         MODULE  -- ciscoWirelessRfMetricsMIB 
  1405.  
  1406.         MANDATORY-GROUPS {
  1407.               p2mpComplianceHistogramGroup
  1408.               }
  1409.  
  1410.         GROUP p2mpComplianceThresholdGroup
  1411.                 DESCRIPTION
  1412.                 "This group is mandatory for a system that supports the
  1413.                 radio head end feature. It is optional at the
  1414.                 Subscriber Unit."
  1415.  
  1416.         GROUP p2mpComplianceTimelineGroup
  1417.                 DESCRIPTION
  1418.                 "This group is optional at the head end and the
  1419.                 Subscriber Unit."
  1420.  
  1421.         GROUP p2mpComplianceSnapshotGroup
  1422.                 DESCRIPTION
  1423.                 "This group is optional at the head end and the
  1424.                 Subscriber Unit."
  1425.  
  1426.         ::= { p2mpRadioRfCompliances 1 }
  1427.  
  1428. --
  1429. --
  1430. p2mpComplianceHistogramGroup OBJECT-GROUP
  1431.         OBJECTS {
  1432.             p2mpHistSize,
  1433.                 p2mpHistSumScale,
  1434.                 p2mpHistSumPrecision,
  1435.                 p2mpStartBinValue,
  1436.                 p2mpEndBinValue,
  1437.                 p2mpUpdateRate,
  1438.                 p2mpCollDuration,
  1439.             p2mpPeriodicSum,
  1440.                 p2mpHistOwner,
  1441.                 p2mpHistAction,
  1442.                 p2mpHistStatus,
  1443.                 p2mpHistRowStatus,
  1444.                 p2mpHistUpdateTime,
  1445.                 p2mpHistMin,
  1446.                 p2mpHistMax,
  1447.                 p2mpHistMean,
  1448.                 p2mpValue
  1449.                 }
  1450.         STATUS      current
  1451.         DESCRIPTION
  1452.         "Group of objects implemented in the point to multipoint wireless
  1453.          system for capturing histograms and snapshots of radio signal 
  1454.          parameters on the radio interface."
  1455.         ::= { p2mpRadioRfGroups 1 }
  1456.  
  1457. --
  1458. --
  1459. p2mpComplianceThresholdGroup OBJECT-GROUP
  1460.         OBJECTS {
  1461.                 p2mpThreshValue,
  1462.                 p2mpThreshHysteresisTime,
  1463.                 p2mpThreshLimitTime,
  1464.                 p2mpThreshRowStatus
  1465.                 }
  1466.         STATUS      current
  1467.         DESCRIPTION
  1468.         "Group of objects implemented in the point to multipoint 
  1469.          wireless system to set thresholds on the radio interface." 
  1470.         ::= { p2mpRadioRfGroups 2 }
  1471.  
  1472. --
  1473. -- Optional Timeline Group
  1474. --
  1475. p2mpComplianceTimelineGroup OBJECT-GROUP
  1476.         OBJECTS {
  1477.                 p2mpTlThreshAttribute,
  1478.                 p2mpTlThreshType,
  1479.                 p2mpTlNumDataValues,
  1480.                 p2mpTlDataScale,
  1481.                 p2mpTlDataPrecision,
  1482.                 p2mpTlSamplePeriod,
  1483.                 p2mpTlAction,
  1484.                 p2mpTlPostTrigBufMgmt,
  1485.                 p2mpTlOwner,
  1486.                 p2mpTlStatus,
  1487.                 p2mpTlRowStatus,
  1488.                 p2mpTlUpdateTime,
  1489.                 p2mpTlNumValues,
  1490.                 p2mpTlTriggerLoc,
  1491.                 p2mpTlValue
  1492.                 }
  1493.         STATUS      current
  1494.         DESCRIPTION
  1495.         "Group of objects implemented in the point to point wireless
  1496.         system for establishing thresholds and capturing timeline data."
  1497.         ::= { p2mpRadioRfGroups 3 }
  1498.  
  1499. --
  1500. -- Optional Snapshot Group
  1501. --
  1502. p2mpComplianceSnapshotGroup OBJECT-GROUP
  1503.         OBJECTS {
  1504.                 p2mpSnapshotType,
  1505.                 p2mpSnapshotDataScale,
  1506.                 p2mpSnapshotDataPrecision,
  1507.                 p2mpSnapshotOwner,
  1508.                 p2mpSnapshotAction,
  1509.                 p2mpSnapshotStatus,
  1510.                 p2mpSnapshotRowStatus,
  1511.                 p2mpSnapAttr1Id,
  1512.                 p2mpSnapAttr1Size,
  1513.                 p2mpSnapAttr2Id,
  1514.                 p2mpSnapAttr2Size,
  1515.                 p2mpSnapAttr3Id,
  1516.                 p2mpSnapAttr3Size,
  1517.                 p2mpSnapAttr4Id,
  1518.                 p2mpSnapAttr4Size,
  1519.                 p2mpRealPart,
  1520.                 p2mpImaginaryPart
  1521.                 }
  1522.         STATUS      current
  1523.         DESCRIPTION
  1524.         "Group of objects implemented in the point to multi point 
  1525.          wireless system for capturing snapshots of various parameters
  1526.          on the radio interface."
  1527.         ::= { p2mpRadioRfGroups 4 }
  1528.  
  1529. END
  1530.